Documentation on uvtriple

Task: uvtriple
Purpose: Make phase or amplitude plots of the triple product from a
Categories: uv analysis, plotting

  UVTRIPLE - Plot triple product phase or amplitude from visibility data
        bases. Options are available to time average data and to plot
       different triples on separate sub-plots on each page.

Key: vis
        The input visibility file(s). Multiple input files and wild card
        card expansion are supported.    
        No default

Key: line
        Line type of the data in the format
          type,nchan,start,width,step
        Here "type" can be one of:  channel, wide or velocity
        If you select more than one channel, they will all appear
        on the plot.  If you want to average channels together,
        then use WIDTH appropriately.
        Default is channel,1,1,1,1

Key: select
        This selects which visibilities to be used. Default is all
        visibilities. See the Users Guide for information about how
        to specify uv data selection.
        Default is all data

Key: stokes
        Select Stokes parameter(s) or polarization(s) from:
          xx, yy, xy, yx,  i, q, u, v, 
          rr, ll, rl, lr
        Default is all polarizations or Stokes parameters present

Key: axis
        Two values, one for each axis. Minimum match is active.
        Values for the x-axis chosen from:
          time                     [DD HH MM SS.S format]
          dtime                    [decimal days  format]
        Values for the y-axis chosen from:
          phase                    [degrees]
          amplitude                [natural units] 

Key: xrange
        Plot range for the x-axis 
          If axis = time                  [dd,hh,mm,ss.s; 8 values]
          If axis = dtime                 [decimal days;  2 values]
        Default is to self-scale (see also OPTIONS=XIND).

Key: yrange
        Plot range for the y-axis 
          If axis = phase                 [degrees;       2 values]
          If axis = amplitude             [natural units; 2 values]
        Default is to self-scale (see also OPTIONS=YIND).

Key: average
        The averaging time in minutes.	Averaging is reset at frequency, 
        source, or pointing centre changes.  Individual triples and 
        polarizations are averaged separately (unless OPTIONS=AVALL).
        If you have selected multiple channels and you also ask for 
        time averaging, then all the selected channels are averaged 
        together in the time interval.
        Default is no averaging.

Key: inc
        Plot every INCth point (on each sub-plot) that would normally 
        have been selected.   Useful if you don't want to average, but 
        want to cut down on the number of plotted points.  Beware of 
        increments that divide exactly into the number of triples in
        time ordered data.  
        Default is 1.

Key: options
        Task enrichment options. Minimum match is effective. 
         nocal   Don't apply the gain corrections
         nopol   Don't apply the polarization leakage corrections
         nopass  Don't apply the bandpass corrections

         notrip  Plot all triples on the same plot, otherwise each
                 triple is plotted on a separate sub-plot.

         avall   If you are averaging in time, then average all triples
        	 selected on each sub-plot together.  E.g. all selected
        	 polarizations, and, if OPTIONS=NOTRIP, all triples
        	 as well.
         unwrap  When plotting phase, try to unwrap it so that
                 say, if one point is 179 deg and the next -179,
        	 they will be plotted as 179 and 181 deg.  NOTE:
        	 Unwrapping noise can be VERY misleading.

         all     Use flagged and unflagged visibilties
         flagged Use only flagged visibilities
        	 The default is to use only unflagged (good) visibilities
                 ALL overrides  FLAGGED

         xind    If the x-axis is self-scaled, then unless OPTIONS=NOTRIP,
                 setting XIND will cause each sub-plot to have the x-axis 
        	 self-scaled independently.  The default is that the x-range
        	 used is that which encompasses the ranges from all sub-plots.
         yind    The equivalent for the y-axis

         symbols Each file is plotted with a different plot symbol
        colours Each file is plotted with a different colour. Only works
                if plotting one polarization.
         dots    If time averaging is invoked, plot the data with dots
                 rather than filled in circles.  These plot much faster
        	 on hardcopy devices.

         log     Write the numbers that are plotted into the log file.
                 No attempt to separate baselines is made, except that
                 automatically obtained by not setting OPTIONS=NOTRIP

Key: device
        PGPLOT plot device/type. No default.

Key: nxy
        Number of plots in the x and y directions for when plotting
        each baseline separately. Defaults try to choose something
        sensible.

Key: size
        PGPLOT character sizes, in units of the default size (i.e., 1)
        First value is for the labels, the second is for the symbol size
        Defaults are 1.7,1.7  and the second value defaults to the first.

Key: log
        The output logfile name. The default is the terminal.